Routines (alphabetical) > Routines: I > ISETCURRENT

ISETCURRENT

Syntax | Arguments | Keywords | Example | Version History | See Also

Syntax

ISETCURRENT [, iToolID] [, /SHOW]

Arguments

iToolID

The identifier of the existing iTool to be set as current.

Keywords

SHOW

Set this keyword to set iToolID as the current tool, and ensure the tool is visible and has focus. If iToolID is not provided, the current iTool visualization is placed in front and given focus.

Example

In the following example, we create three iPlot iTools and display the ID for each one. At the end, we set the first iTool created as the current iTool.

IPLOT, RANDOMU(seed, 30), IDENTIFIER = iToolID1, $

   COLOR = [0, 0, 255]

currentTool = IGETCURRENT()

PRINT, 'The current tool is ', currentTool

 

IPLOT, RANDOMU(seed, 30), IDENTIFIER = iToolID2, $

   COLOR = [0, 255, 0]

currentTool = IGETCURRENT()

PRINT, 'The current tool is ', currentTool

 

IPLOT, RANDOMU(seed, 30), IDENTIFIER = iToolID3, $

   COLOR = [255, 0, 0]

currentTool = IGETCURRENT()

PRINT, 'The current tool is ', currentTool

ISETCURRENT, iToolID1currentTool = IGETCURRENT()

PRINT, 'The current tool is ', currentTool

PRINT, 'The first tool is ', iToolID1

Version History

 

6.0

Introduced

7.1

Added the SHOW keyword.
Routine name changed from ITCURRENT to ISETCURRENT.

See Also

IDELETE, IGETCURRENT, IRESET